NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: Source Routing Files DOCUMENT ID: TID014592 DOCUMENT REVISION: A DATE: 24JAN94 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: SROUT2.EXE NOVELL PRODUCT and VERSION: NetWare Pre 3.11 and 2.2 NetWare 2.2 NetWare 3.11 NetWare 3.12 NetWare 4.01 ABSTRACT: The files contained are for implementing the ability for Novell servers, routers, and DOS, Windows, OS2, TCPIP clients to SOURCE ROUTE their frames on FDDI, Token-Ring, and PCNET networks. These files include the ability to handle up to 13 Source Routing Bridge hops as specified in the new IEEE SRT specification. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 SYMPTOM Changes/Fixes ROUTE.com and ROUTE.nlm parameters have been modified to remain consistent with the IEEE 802.1d Source Routing Transparent (SRT) Operation Specification and ISO/IEC 8802-2/DAM 5.3 Route Determination Entity Specification. The following changes have been made: Added New Parameter (XTX=nn) to ROUTE.com and ROUTE.nlm to allow an extra send count. ROUTE.com and ROUTE.nlm will transmit XTX times after a route is timed out before resorting to single route broadcasts. Changed the Aging Timer Algorithm for ROUTE.com and ROUTE.nlm so that a value of TIME=00 means the route will NEVER time out. Changed TIME= parameter's range to TIME=0-3640 for ROUTE.com. Changed TIME= parameter's range to TIME=0-65535 for ROUTE.nlm. Added NAME= parameter to ROUTE.nlm so that user can load route by board name instead of BOARD=. Changed the default RSP value in ROUTE.nlm to RSP=AR. SOLUTION Apply SROUT2.EXE. Self-Extracting File Name: SROUT2.EXE Revision: A Files Included Size Date Time \ SROUT2.TXT (This File) ROUTE.COM 4903 12-01-93 11:53a v2.20 ROUTE.NLM 5013 12-01-93 12:01p v4.10 ROUTE.SYS 45440 08-12-93 10:58a v4.11 ROUTE.VP0 3896 11-04-93 10:50a v1.10 SRCONFIG.COM 5396 07-08-92 2:21p v2.00 Installation Instructions: ROUTE.COM - NetWare Source Routing Driver v2.20 for DOS. All command line parameters (for AUTOEXEC.BAT) are described below: ROUTE U,BOARD=dd,CLEAR,DEF,GBR,HOPS=dd,MBR,NODES=dd,TIME=ss,TRA=d d,TRO=dd,XTX=nn ? Gives a help display of all ROUTE.COM syntax if ROUTE.COM has not been loaded. If ROUTE.COM has already been loaded, the source routing table is dumped to the screen or can be redirected to a file. U Unload a previously installed Source Router (ROUTE.COM) from memory. BOARD=dd A DECIMAL board number as assigned by ODI. This parameter is only for use with ODI drivers. Do not use this parameter if you are using dedicated IPX Drivers. CLEAR CLEAR ALL Nodes from a previously loaded Source Router. This clears an existing source routing table of all entries. DEF Send DEFault (Unknown) Node Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. GBR Send Broadcast (FFFF FFFF FFFF) Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. HOPS=dd A DECIMAL number specifying the number of bridge hops to configure. The DEFAULT is 07, and the MAXIMUM is 13; the minimum is 01. This parameter adjusts the size of the source routing table to allow up to 13 source routing bridge hops per table entry. If "0" is specified, the default of 07 is used. To conserve memory, this number should be set as low as possible while still allowing for the maximum number of bridge hops possible on the network. MBR Send MultiCast (C000 xxxx xxxx) Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. NODES=dd A DECIMAL number of NODE Addresses to support. The DEFAULT is 16, and the MAXIMUM is 1000. If the value is less than 08, then 08 is used. TIME=ss A DECIMAL number specifying the number of seconds to wait before a known route is timed out. The DEFAULT is 10, and the MAXIMUM is 3640. On receives, a timed out route will be updated. On transmits, a timed out route will not be used; instead, the frame will be all-routes or single-routes broadcast according to the "DEF" parameter. The full range of ss = 0-3640. If ss=0, time-outs are disabled and routes will NEVER be timed out. ss=0 is not recommended where alternate bridge routes have been incorporated into the design of the network. XTX=nn A DECIMAL number specifying the number of extra transmits on a route that has been timed-out by the TIME= setting. This allows the route to be timed-back-in before SR or AR broadcasts are sent out (per the "DEF" parameter). The default is XTX=1, and the full range is XTX = 0 - 255. TRA=dd A DECIMAL number specifying a THIS RING ALTERNATE count for Broadcasts. The Source Router will alternate between SOURCE ROUTED and NON-SOURCE ROUTED broadcasts. The DEFAULT is 00, and the MAXIMUM is 255. Example: If TRA=2 is used, and the IPX Retry Count is 20, then the first two retries would not be source routed. If no response to these broadcasts is received, the next two retries would be source routed. Each pair of retries alternates back and forth from non-source-routed to source routed until all IPX Retries are exhausted. Note: The TRA value must be less than the IPX retry count. TRO=dd A DECIMAL number specifying a THIS RING ONLY count for Broadcasts. The DEFAULT is 00, and the MAXIMUM is 255. All of the above ROUTE.COM parameters are optional, are not case sensitive, and may be entered in any order. They may be used to SET the source router (ROUTE.COM) that is being loaded, or CHANGE the configuration of a previously loaded source router (ROUTE.COM). All of these parameter defaults may be changed by SRCONFIG.COM. ROUTE.VP0 - Novell 286 OS Source Routing VAP 1.10 (931104). Use SRCONFIG.COM to configure the source routing VAP. Each route table entry supports up to 13 source routing bridge hops by default. There is a maximum of 250 table entries. NetWare console commands for ROUTE.VP0 appear below: ROUTE BOARD=n,CLEAR,DEF,GBR,MBR,REMOVE=xxxxxxxxxxxx,RSP=rr,TIME=ss BOARD=n n is the LAN Driver Board: A, B, C, or D. If NOT entered, BOARD=A is ASSUMED. CLEAR CLEAR ALL Nodes from a previously loaded Source Router. DEF Send DEFault (Unknown) Node Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. GBR Send Broadcast (FFFF FFFF FFFF) Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. MBR Send MultiCast (C000 xxxx xxxx) Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. REMOVE=xx xx is A HEXADECIMAL NODE Address to REMOVE from a previously loaded Source Router. If less than 09 hexadecimal digits are entered, then 4000 xxxx xxxx is assumed. Example: ROUTE REMOVE=10005A123456 will delete node 10005A123456 from the source routing table maintained by ROUTE.VP0. RSP=AR Respond to Broadcast Requests through ALL ROUTES Broadcast. RSP=SR Respond to Broadcast Requests through SINGLE ROUTE Broadcast. RSP=NR Respond DIRECTLY to a Broadcast Request. This is the DEFAULT. TIME=ss ss is the number of SECONDS that the Source Router should wait before updating its Source Routing Table. The DEFAULT is 03 seconds. All parameters are separated by commas or blanks, are optional, are not case sensitive, and may be entered in any order at the 286 console prompt. All parameter defaults may be changed by SRCONFIG.COM. SRCONFIG.COM - Novell Source Routing Configuration Utility 2.00 (920708) has been updated to configure the new features in ROUTE.COM. SRCONFIG.COM will change the default parameters of ROUTE.VP0 and ROUTE.COM only. ROUTE.NLM - Novell Source Routing NLM 4.10. It works with NetWare 3.x and 4.x file servers and routers and bridges. It has been updated to comply with the new SRT Bridging standard where up to 13 SRT bridge hops can take place on a network. The source routing table built and maintained by route.nlm is now increased from 18 bytes to 30 bytes per table entry. This is not configurable. There is no limit to the number of route table entries that can be maintained by ROUTE.NLM. The number of table entries is limited only by the amount of RAM installed in the NetWare 386 file server. Valid parameters for ROUTE.NLM 4.10 are the following: LOAD [d:]ROUTE BOARD=dd,NAME=yy,CLEAR,DEF,GBR,MBR,REMOVE=xxxxxxxxxxxx,RSP=rr,TI ME=ss,XTX=nn BOARD=dd dd is a DECIMAL board number as assigned by the System. If this parameter is not entered, BOARD=1 is ASSUMED. NAME=yy Cyy is an alphanumeric name that was given to the lan board when the lan driver was loaded. The NAME= parameter allows the user to load route by board name instead of BOARD=. CLEAR CLEAR ALL Nodes from a previously loaded Source Router. DEF Send DEFault (Unknown) Node Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. GBR Send Broadcast (FFFF FFFF FFFF) Addresses ALL ROUTES Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. MBR Send MultiCast (C000 xxxx xxxx) Addresses ALL ROUTE Broadcast. If this parameter is not entered, SINGLE ROUTE Broadcast is assumed. REMOVE=xx xx is a HEXADECIMAL NODE Address to REMOVE from a previously loaded Source Router. If less than 09 hexadecimal digits are entered, then 4000 xxxx xxxx is assumed. RSP=AR Respond to Broadcast Requests through ALL ROUTES Broadcast. This is the DEFAULT for the RSP parameter. RSP=SR Respond to Broadcast Requests through SINGLE ROUTE Broadcast. RSP=NR Respond DIRECTLY to a Broadcast Request. TIME=ss A DECIMAL number specifying the number of seconds to wait before a known route is timed out. The DEFAULT is 10, and the MAXIMUM is 65535. On receives, a timed out route will be updated. On transmits, the timed out route will not be used; however, the frame will be all-routes or single-routes broadcast according to the "DEF" parameter. The full range of ss = 0-65535. If ss=0, time-outs are disabled and routes will NEVER be timed out. ss=0 is not recommended for where alternate bridge routes have been incorporated into the design of the network. XTX=xx A DECIMAL number specifying the number of extra transmits on a timed-out route (see TIME=ss parameter). This allows the route to be timed-back-in before any single-routes or all-routes broadcasts are used according to the "DEF" parameter. The default is XTX=1, and the full range is: XTX = 0-255. All ROUTE.NLM parameters are optional, are not case sensitive, and may be entered in any order. They may be used to SET the Source Router that is being loaded, or CHANGE the configuration of a previously loaded source router. ROUTE.SYS - NetWare for OS/2 4.11 (930812) Source Routing Support driver. The syntax for ROUTE.SYS must appear in the NET.CFG file. The syntax is as follows: protocol route source route def gbr mbr nodes n board n def When def is specified, frames with an unknown destination node address are sent "all routes." If def is not specified, the default is "single routes." gbr When gbr is specified, broadcast frames are sent "all routes." If gbr is not specified, then broadcast frames are sent "single routes," which is the default. mbr When mbr is specified, multicast (or functional) frames are sent "all routes." If mbr is not specified, then multicast (functional) frames are sent "single routes." nodes n n specifies the number of route table entries allowed in the route table maintained by ROUTE.SYS. n is a decimal number from 8 to 255. The default is 16. board n n is the logical board number of the board performing the source routing. �